home *** CD-ROM | disk | FTP | other *** search
/ Scene 96 / Scene 96 International Edition (Zyklop Software) (Disc 1) (1997).iso / emulator / amiga065 / docs / readme < prev    next >
Text File  |  1996-12-20  |  27KB  |  592 lines
  1. This is version 0.6.5 of UAE, the Un*x Amiga Emulator.
  2.  
  3. #include <drivel.h>
  4.  
  5. Copyright 1995, 1996 Bernd Schmidt & contributors (see below). This program is
  6. freeware. You may do whatever you want with it for personal use.
  7. Permission is granted to redistribute this program free of charge, provided it 
  8. is distributed in the full archive with unmodified contents and no profit 
  9. beyond the price of the media on which it is distributed is made. Exception to
  10. the last rule: It may be included on freeware/shareware collections on CD-ROM.
  11. There are no warranties of any kind for this program. If you use this program,
  12. you do so at your own risk. The authors are not responsible for any damages 
  13. that might result from using this program.
  14. "Amiga" is a registered trademark of Commodore, Inc. Other trademarks
  15. mentioned in this document are property of their owners.
  16.  
  17.  
  18. Overview
  19. ========
  20.  
  21. An emulator is a program which enables you to run software for a machine
  22. which has non-native hardware and a non-native operating system, on your
  23. computer.  UAE allows you to run most of the available Amiga software. It is a
  24. software emulation, meaning that no extra or special hardware is needed to do
  25. this. The hardware of an Amiga is emulated accurately, so that Amiga software
  26. is tricked into thinking it is running on the real thing, with your computer's
  27. display, keyboard, harddisk and mouse taking the parts of their emulated
  28. counterparts.
  29.  
  30. UAE was developed for Unixoid systems. Meanwhile, it has been ported to the
  31. Mac, DOS, the BeBox, NextStep, the XFree86/OS2 environment and the Amigas (it
  32. can run itself by now). You should have received several other files along
  33. with this document with details on how to install and use the version for your
  34. operating system.
  35.  
  36. This section is just what it says: an overview. Please read _all_ of this
  37. file, especially if you have problems. UAE has many, many features and
  38. equally many configuration options. If you don't know about them, it's likely
  39. that UAE doesn't work for you, or doesn't work as good as it could.
  40.  
  41. Please read also the file "FAQ" which contains some Frequently Asked
  42. Questions (and even the answers!) System-specific documents like "README.UNIX"
  43. and "README.DOS" also exist, you should read the appropriate one, too.
  44.  
  45. People have complained that the UAE documentation contains only "weird jargon".
  46. Sorry about this. Despite what MessySoft and Tomato tell you, computer
  47. programs aren't always easy to use. UAE does require some assistance from you,
  48. and therefore you should at least understand a bit about computers. After all,
  49. you are an Amiga fan, so you should know what a Workbench is, don't you think?
  50.  
  51.  
  52. Features
  53. ========
  54.  
  55. This version of UAE emulates:
  56.  
  57. - An Amiga 500 Computer, with 68000 or 68020 CPU (68020 includes 68881 FPU)
  58. - OCS Graphics Chipset, plus big blits from the ECS Chipset
  59. - Up to 2MB Chip RAM
  60. - Up to 8MB Fast RAM
  61. - Up to 1MB Slow RAM, for extended compatability with problem software
  62. - 4 x 3.5" floppy disk drives (DF0:, DF1:, DF2: and DF3:)
  63. - Hard-disk emulation
  64. - Joystick support (with option of mapping joystick to numeric keypad)
  65. - Mouse support
  66. - Ability to run in various screen modes (for better display quality or
  67.   better speed)
  68. - Full sound support, consisting of 4 x 8bit channels (mixed into one, so
  69.   output is mono for now).
  70. - Beta parallel port support
  71. - some other things which don't work well enough to mention them here...
  72.  
  73.   
  74. Requirements (IMPORTANT! READ THIS!)/Limitations
  75. ================================================
  76.  
  77. Not emulated:
  78. - Sprite collisions (some other parts of the sprite emulation are buggy)
  79. - a MMU (part of 68030/040 CPUs except those that Commodore used). This means
  80.   you can't use virtual memory systems or real operating systems like Linux
  81.   or BSD.
  82. - The AGA chipset (A4000/A1200). This chipset has enhanced capabilites for
  83.   up to 256 colors in all resolutions.
  84. - Serial port emulation exists but doesn't work too well.
  85.  
  86. Since the PC floppy controller can't read Amiga disks (yes, that's a fact), 
  87. floppy access has to be emulated differently: Floppies are emulated by means 
  88. of disk files that contain a raw image of the floppy disk you want to emulate.
  89. A disk file is an image of the raw data on an Amiga floppy disk, it contains
  90. 901120 bytes (880K), which is the standard capacity of an Amiga disk.
  91.  
  92. To actually run the program, you'll need to install the ROM image from your
  93. Amiga. You can't run UAE if you don't have this image. It is not included
  94. because it is copyrighted software. Don't ask me to send you one. I won't.
  95. If you don't have an Amiga and still want to use UAE, you'll have to buy an
  96. Amiga or at least the system software (ROM + Workbench) first.
  97. The Kickstart image can have a size of either 256K or 512K. It must be named
  98. "kick.rom" by default.
  99.  
  100. Read the section "tools" below for information how to create ROM images and
  101. disk files.
  102.  
  103. If you don't have a Kickstart file, you may still be able to boot some games
  104. and demos. The emulator includes some primitive bootstrap code that will try
  105. to read and execute the bootblock of the diskfile you are using, and if that
  106. bootblock only uses the one or two Kickstart functions that are supported by 
  107. the "replacement Kickstart", your program will boot. Don't expect too much, 
  108. though.
  109.  
  110. You'll also need some other software to run - why else would you want to
  111. emulate an Amiga? There are several ways to make the software accessible to
  112. UAE, either with disk image files or with a harddisk emulation.You should make
  113. an image of your Amiga's Workbench disk and install it as "df0.adf" (adf =
  114. Amiga Disk File) when you use UAE for the first time. More about how to create
  115. these files in the chapter "Transferring software"
  116.  
  117.  
  118. Invoking UAE
  119. ============
  120.  
  121. First, read the system-specific documents for information how to set up UAE.
  122. You should have an executable program called "uae". You can simply execute it,
  123. but you can also optionally give it one of the following
  124. parameters:
  125.  
  126. General options:
  127.  -h      : Give help on the options.
  128.  -A n    : Set emulator accuracy to n. The default is n = 2, which means the
  129.            emulator will try to be as accurate as possible. Some programs will
  130.        run much faster if you use "-A 0"
  131.  -f n    : Sets the frame rate to 1/n. Only every nth screen will be drawn.
  132.  -a      : Add no expansion devices. This will disable fastmem and harddisk
  133.            emulation, but some extremely badly-written games may need this.
  134.  -l lang : Set the keyboard language. Currently, the following values can be 
  135.        used for lang: "us" for U.S. keyboard (default), "se" for swedish, 
  136.        "fr" for french, "it" for italian  or "de" for german keyboard.
  137.  -0 file : Try to use file as diskfile for drive 0 instead of df0.adf.
  138.            -1 file, -2 file and -3 also exist for the other drives.
  139.  -r file : Use file instead of kick.rom as Kickstart image.
  140.  -J      : Use the numeric pad for joystick emulation (with 5 and 0 as fire 
  141.            buttons). This will turn off real joystick support. It's no good 
  142.        for action games, but may be useful for other games.
  143.  -x      : General-purpose option. For the X version, it makes the X cursor 
  144.            visible (recommended). For the SVGAlib version, it turns off
  145.        linear framebuffer support (sometimes, with -d 4, SVGAlib is
  146.        faster without linear framebuffer).
  147.  -o      : Allow UAE to overwrite ~/.uaerc with the selected options. This is
  148.            only used by the text-based GUI in the SVGAlib and DOS versions.
  149.  -G      : Disable the user interface (if present).
  150.  
  151. Emulating external devices (harddisk, printer, serial port):
  152.  -M VOLUME:path
  153.  -m VOLUME:path
  154.            mount the unix file system at path as an Amiga filesystem with
  155.        volume name "VOLUME:". For example, "-M sound:/usr/amiga/modules"
  156.        If you use -M instead of -m, the volume will be read only.
  157.        See below.
  158.  -p cmd  : Enable printing. See below.
  159.  -I dev  : Use "dev" as serial device (e.g. /dev/ttyS1 on Linux). Doesn't
  160.            really work yet, at least not for me.
  161.  
  162. Sound options:
  163.  -S n    : If your version of UAE supports sound, set the sound support level
  164.            with this option.
  165.        n = 0: No proper sound emulation at all. May be incompatible 
  166.               (unlikely). This is the default.
  167.        n = 1: Emulate the sound hardware, but don't output sound. May be
  168.               needed for compatibility, but can be much slower
  169.        n = 2: Emulate the sound hardware and output sound. Recommended.
  170.        n = 3: Emulate the sound hardware _exactly_. I don't think you'll
  171.               hear a difference. SIDmon modules will be emulated 
  172.           correctly, but painfully slow with this setting.
  173.  -b n    : Use n bits for sound output (8 or 16)
  174.  -R n    : Use n Hz to output sound. Common values are 22050 Hz or 44100 Hz.
  175.  -B n    : Use a sound buffer of n bytes (use small values on fast machines)
  176.            Default is 8192.
  177.        
  178. Memory options:
  179.  -s n    : Emulate n*256K slow memory at 0xC00000. Some demos/games need this.
  180.  -F n    : Emulate n megabytes of fast memory as an expansion board.
  181.  -c n    : Emulate n*512K chip memory. The default is 2MB chipram. Some very
  182.            broken programs need "-c 1" to work properly.
  183.        
  184. Debugging options:
  185.  -D      : Don't start the emulator at once, use the built-in debugger.
  186.  -i      : Print illegal memory accesses
  187.  -g      : Emulate parts of the OS. This isn't very stable and not
  188.            recommended.
  189.  
  190. Display options:
  191.  -d mode : Select a graphical resolution for UAE to run in.
  192.  -H mode : Select a color mode to use.
  193.  -C      : Correct the aspect. Normally, graphics will be only half as high
  194.            as they should be, this option draws every line twice to correct
  195.        this. It makes the emulation slower, though.
  196.        Proper emulation of interlace mode is impossible without this
  197.        option.
  198.  
  199. Resolutions: 0 (320x200); 1 (320x240); 2 (320x400); 3 (640x480);
  200.              4 (800x600).
  201. Color modes: 0 (256 colors, default); 1 (32768 colors); 2 (65536 colors)
  202.              3 (256 colors, with dithering to improve color quality)
  203.          4 (16 colors, dithered); 5 (16 million colors)
  204.  
  205. UAE may choose to ignore and/or refuse some combinations of these two
  206. parameters. Some of these modes may also fail to work on your system.
  207.  
  208. For speed reasons, it is _very_ advisable always to use "-A 0" if this
  209. doesn't break your programs. This used to be the default in UAE 0.6.4 and
  210. earlier.
  211.  
  212. You can also put these options into a configuration file in your home
  213. directory. Simply create ~/.uaerc and put some of these options in it. On
  214. non-Unix systems, the file is called uae.rc and should be located in the
  215. current directory.
  216.  
  217.  
  218. Choosing color and screen modes
  219. ===============================
  220.  
  221. As described in the previous paragraph, UAE can run in many different 
  222. resolutions and color modes. However, few of the color mode options are
  223. available if you use the X11 version of UAE, since the X server determines
  224. how many colors are available. If you are running a 256 color X server, you
  225. can use "-H3" to tell UAE to dither the colors for better results.
  226.  
  227. You will have to experiment which mode gives the best results for you at a
  228. satisfying speed. Note that the dithering process consumes time, so even if
  229. 256 colors with dithering look better than 256 colors without, remember that
  230. UAE will be slower in that mode.
  231.  
  232. The recommended resolution is 800x600. In the lower resolution modes, some
  233. overscan pictures the Amiga tries to display may not fit entirely on the
  234. screen, others may be off-center and some graphical effects may look weird.
  235. For best results, use 800x600 with at least 32768 colors.
  236.  
  237.  
  238. Harddisk emulation
  239. ==================
  240.  
  241. Using diskfiles is awkward. There are two ways how you can use larger amounts 
  242. of data with UAE. UAE can emulate more than one harddisk at one time, the
  243. volumes will be named UAE0:, UAE1:, etc. UAE will boot from UAE0: if no
  244. diskfile is found for floppy drive 0.
  245.  
  246. a) Harddisk files.
  247. You can create a (unformatted) harddisk file with
  248.  
  249.   dd if=/dev/zero of=hardfile bs=512 count=16384
  250.  
  251. That will create an 8MB file. Other sizes ought to work, too, as long as they
  252. are powers of two.
  253.  
  254. The harddisk file is accessed by a resident ROM module that is built into the
  255. emulator, called "hardfile.device". If it is present, this is always the first
  256. harddisk device the emulator finds and will be named UAE0:
  257.  
  258. If you are using Kickstart 1.3 or earlier, this can't currently be mounted at 
  259. boot time, and therefore you can't boot from it either. You will have to boot
  260. either from a floppy disk image or from a filesystem (see below), and mount
  261. the hardfile.device later. To do this, add the following to "DEVS:mountlist":
  262.  
  263. UAE0:       Device = hardfile.device
  264.        Unit   = 0
  265.        Flags  = 0
  266.        Surfaces  = 1
  267.        BlocksPerTrack = 32
  268.        Reserved = 1
  269.        Interleave = 0
  270.        LowCyl = 0  ;  HighCyl = 511
  271.        Buffers = 5
  272.        DosType = 0x444F5300
  273.        BufMemType = 1
  274. #
  275.  
  276. Then, type "mount UAE0:" (or put that command in your startup-sequence), and
  277. you should be able to access it. Don't forget to format it with the AmigaDOS
  278. format command:
  279.  
  280.   format drive uae0: name Mister_Willwink
  281.  
  282. The emulated Amiga usually crashes after the format command. I don't know
  283. exactly why.
  284.  
  285. b) Access native filesystems from the emulator.
  286.  
  287. This has some major advantages:
  288.  - It has no problems with Kickstart 1.3
  289.  - It is more convenient.
  290.  - It is much faster. In fact, it can be dramatically faster even than a real
  291.    Amiga when reading directories.
  292.  
  293. However, it currently does not work on some ports.
  294.  
  295. If you specify the -M or -m command line arguments, you your native filesystem 
  296. from the emulator. If you start UAE with
  297.  
  298.   uae -m sound:/usr/amiga/modules
  299.   
  300. you can access all the files in /usr/amiga/modules by reading from the
  301. AmigaDOS volume "SOUND:".
  302. (DOS users: try "uae -m dh0:C:\" to mount your drive C:\ as DH0:)
  303.  
  304. You can mount up to 20 devices by giving this option multiple times.
  305.  
  306.  
  307. Tools / Transferring files
  308. ==========================
  309.  
  310. As you should know by now, you need to transfer files between your Amiga and
  311. the machine you run UAE on. There are several ways how to do this.
  312.  
  313. - Using a null modem cable, and a terminal package running on each machine,
  314.   you can transfer the file(s) via Zmodem upload/download. 68000 equipped
  315.   Amigas can normally attain around 3000cps through the null modem cable,
  316.   using the standard Commodore serial.device.  However, by using the device
  317.   replacement BaudBandit.device, anything up to 5500cps can be attained.
  318.   BaudBandit can be obtained from Aminet.  A second alternative is to use
  319.   the BASIC program adfi.bas (included with UAE) to transfer a file from the
  320.   Amiga to the PC via the null modem cable.
  321.   
  322. - If you're using CrossDOS on your Amiga, you can compress the disk or
  323.   kickstart image using LhA or similar PC compatible archiver and copy it to
  324.   a 720KB floppy disk.  You can now take the disk over to the PC, copy the
  325.   compressed file to the UAE directory and uncompress it.
  326.   If you don't have CrossDOS on the Amiga, there is a similar freeware tool
  327.   called Msh, which can be found on Aminet or on Fish disk 382 or 327.
  328.  
  329. In either case, you ought to read the documentation for the programs that
  330. you use for the transfer. These programs can't be explained here.
  331.  
  332. In the "amiga" subdirectory you'll find two small Amiga programs that will
  333. help you to generate the necessary image files. These are called transrom 
  334. and transdisk. Copy them to your Amiga and make them executable (by typing
  335. "protect transrom rwed" and "protect transdisk rwed" in the Amiga shell
  336. window).
  337. transrom will dump the contents of your Kickstart ROM, and transdisk will 
  338. dump an image of a floppy in one of the drives. Both programs write to the
  339. standard output (read: the screen), so you'll want to redirect that. Do
  340.  
  341.    transrom >ram:kick.rom
  342.    
  343. to create a file called "kick.rom" in the RAM disk, and
  344.  
  345.    transdisk >ram:df0.adf
  346.    
  347. to create a file called "df0.adf" in the RAM disk. These files are pretty
  348. big, 262144 or 524288 bytes for the ROM image and 901120 bytes for a disk 
  349. image.
  350. transdisk understands the following arguments:
  351.  
  352.     -d device unit: Use this device instead of DF0:
  353.     -s n:           Begin transfer at track n (default: 0)
  354.     -e n:           End transfer at track n (default: 79)
  355.     -w file:        don't read from the floppy, instead write the contents
  356.                     of "file" to the floppy
  357.     -h:             Treat the disk as high-density disk. HD images aren't
  358.                     supported by UAE yet, though. Note that the resulting
  359.             file will be twice as big.
  360.  
  361. So, to transfer the disk in drive DF1:, you'd give the command:
  362.  
  363.   transdisk >ram:df1.adf -d trackdisk 1
  364.  
  365. If you don't have much RAM and can't fit all of a disk image in the RAM disk,
  366. you can split up the transfer into multiple parts with the "-s" and "-e"
  367. parameters. To transfer the disk in four parts, you'd use the following 
  368. commands:
  369.   
  370.   transdisk >ram:df0_1.adf -s 0 -e 19
  371.   transdisk >ram:df0_2.adf -s 20 -e 39
  372.   transdisk >ram:df0_3.adf -s 40 -e 59
  373.   transdisk >ram:df0_4.adf -s 60 -e 79
  374.  
  375. Of course, you should save each of the four files to another place before
  376. transferring the next one with transdisk to make space in your RAM disk. 
  377. If you have all the files on your PC, you can do the following under Unix:
  378.   cat df0_1.adf df0_2.adf df0_3.adf df0_4.adf >df0.adf
  379. or, under DOS:
  380.   COPY /B df0_1.adf+df0_2.adf+df0_3.adf+df0_4.adf df0.adf
  381. I've been told there are the following tools for the Mac to join binaries:
  382. "ChunkJoiner 2.1.2" found under Info-Mac's <disk> directory or 
  383. "JoinFiles 1.0.1" under Info-Mac's <text>.
  384.  
  385. The current transdisk can only read the standard AmigaDOS format. This means
  386. that most games that rely on some form of copy-protection cannot be
  387. transferred (more about disk formats in the file "FAQ")
  388.  
  389. ****************************************************************************
  390. If you transfer commercial software, you must not distribute the resulting
  391. image files, since that would be a violation of copyright law. The Kickstart
  392. ROM has to be considered commercial software. You may only use the Kickstart
  393. from your own Amiga, and you may not distribute Kickstart ROM files.
  394. Please read the license that came with your software for details.
  395. ****************************************************************************
  396.  
  397.  
  398. Retrieving files from a disk image
  399. ==================================
  400.  
  401. If you have a disk image file, and you want to retrieve the files from it, you
  402. can use the "readdisk" tool. It is automatically built by "make". If you have
  403. a disk image of a disk called "Workbench1.3D" as df0.adf, and you do
  404.    readdisk df0.adf
  405. the whole directory structure of the disk image will be stored in a newly
  406. created subdirectory called "Workbench1.3D". You can optionally give a second
  407. parameter to specify a directory where to create the output other than the
  408. current directory.
  409. readdisk only understands about the OFS right now. FFS disks will cheerfully
  410. be regarded as being unreadable. Use the unixfs.device from within the
  411. emulator if you want to transfer files from FFS disks.
  412.  
  413.  
  414. The UAE_CONTROL program
  415. =======================
  416.  
  417. In the "amiga" subdirectory, you will find two programs, uae_control and
  418. uaectrl that provide the same functionality as the X11 GUI. uaectrl is
  419. shell-based and works with any Kickstart, while uae_control needs the
  420. gadtools.library and a recent version of reqtools.library, so it only works
  421. with Kick 2.0 and upwards. Copy these two programs to the directory that you
  422. use for harddisk emulation. They should be self-explanatory.
  423.  
  424.  
  425. Quick overview of the debugger commands
  426. =======================================
  427.  
  428. Some (window-system based) ports of UAE have a built-in debugger. You can
  429. press ^C at any time to enter this debugger.
  430. Each debugger command consists of a single letter and occasionally some
  431. parameters.
  432.  
  433. g:                    Start execution at the current address. 
  434. c:                    Dump state of the CIA and custom chips.
  435. r:                    Dump state of the CPU
  436. m <address> <lines>:  Memory dump starting at <address>
  437. d <address> <lines>:  Disassembly starting at <address>
  438. t:                    Step one instruction
  439. z:                    Step through one instruction - useful for JSR, DBRA etc.
  440. f <address>:          Step forward until PC == <address>
  441. q:                    Quit the emulator. You don't want to use this command.
  442.  
  443.  
  444. Sound
  445. =====
  446.  
  447. If your version of UAE supports sound, you can pass parameters like frequency
  448. or number of bits to use on the commandline; if you don't specify any, sane
  449. defaults will be used. If graphics output is enabled while sound is output,
  450. the emulator will be much too slow on most systems. The sound will not be
  451. continuous. Therefore, a hack to turn off screen updates is provided: Press
  452. ScrollLock to disable graphics, press it again to enable them.
  453.  
  454. The quality of the emulation depends on the setting of the "-S" commandline
  455. option. With "-S 3", all of the sound hardware is emulated; and some programs
  456. (e.g. AIBB) won't run with other settings. "-S 2" should sound just as good as
  457. "-S 3" and will be much faster for some programs. "-S 1" tries to emulate most
  458. of the sound hardware, but doesn't actually output sound. "-S 0" completely
  459. turns off sound.
  460.  
  461.  
  462. Pointers
  463. ========
  464.  
  465. There are a few sites in the Internet that contain helpful information about
  466. UAE.
  467.  
  468. I have set up a WEB page for UAE. You will find interim versions, Linux
  469. binaries, diskfiles with Amiga software and other interesting stuff there.
  470. The address is
  471.  
  472. http://www-users.informatik.rwth-aachen.de/~crux/uae.html
  473.  
  474. However, this page is very likely to go away soon since the university
  475. announced they will only keep "official" pages in the future. So, the new
  476. UAE page is located at
  477.  
  478. http://www.schokola.de/~stepan/uae
  479.  
  480. thanks to Stefan Reinauer who is now maintaining it.
  481.  
  482. There, you will find links to other UAE pages. One which is especially useful
  483. is the "UAE Discussion Board" set up by Gustavo Goedert, the address is
  484.  
  485. http://tinos.pucrs.br/~ggoedert/uaeboard.html
  486.  
  487. Not quite as good as a newsgroup due to braindamaged reader software
  488. (Ratscope), but still a blessing.
  489.  
  490. I post announcements of new versions of UAE to the newsgroup 
  491. comp.emulators.misc. From time to time, I also upload new versions to the ftp
  492. server sunsite.unc.edu. You will find them either in pub/Linux/Incoming or in
  493. pub/Linux/system/Emulators. There are many sunsite mirrors throughout the
  494. world, you should be able to find one near you.
  495.  
  496.  
  497. Thanks & Acknowledgements
  498. =========================
  499.  
  500. Thanks to all who have written me so far with bugreports and success/failure
  501. reports when trying to run the emulator on various hardware with different
  502. Kickstart versions. A list of everyone who has contributed to the source code
  503. can be found in the CREDITS file (this was getting too big to keep it here).
  504.  
  505. Special thanks to:
  506.   - Jay Miner, Dale Luck, R.J. Mical and all the others who built the Amiga.
  507.   - Felix Bardos, whose HRM I "borrowed".
  508.   - Hetz Ben Hamo mailed Peter Kittel from Commodore asking for permission to
  509.     give Kick 1.3 away. Unfortunately, the response was negative :-(
  510.   - Bruno Coste, Ed Hanway, Alessandro Soldo and Marko Nippula provided 
  511.     documentation
  512.   - Fabio Ciucci gets the "Best bug reports" award for his help with the
  513.     blitter line emulation and other problem areas.
  514.   - Michael C. Battilana of Cloanto Software, for being so kind to send me two
  515.     CD-ROMs with lots of Amiga software.
  516.  
  517.  
  518. Authors/Maintainers
  519. ===================
  520.  
  521. My address is:
  522.  
  523. crux@pool.informatik.rwth-aachen.de
  524.  
  525. or, via snailmail
  526.  
  527. Bernd Schmidt
  528. Schlossweiherstrasse 14
  529. 52072 Aachen
  530. Germany
  531.  
  532. Email is more likely to be answered, and will definitely be answered much
  533. faster. Please avoid phonecalls if you can.
  534.  
  535. The following people have ported UAE to different platforms; you should
  536. direct system-specific questions to them:
  537.  
  538. DOS port:
  539.   Gustavo Goedert <ggoedert@music.pucrs.br>
  540.   Available: http://tinos.pucrs.br/~ggoedert/dosuae.html
  541.  
  542. Mac port:
  543.   Ernesto Corvi <macsupport@overnet.com.ar>
  544.   Available: info-mac ("every Mac user knows where that is"). A link to the 
  545.   archive containing both PPC and 68k binaries is on my Web page. (info-mac
  546.   is mirrored by sunsite.informatik.rwth-aachen.de)
  547.  
  548. BeBox port:
  549.   Christian Bauer <bauec002@goofy.zdv.uni-mainz.de>
  550.   Available: My web page (use the Unix sources)
  551.  
  552. NextStep port:
  553.   Ian Stephenson <ians@cam-ani.co.uk>
  554.   Available: My web page (use the Unix sources)
  555.  
  556. Amiga port:
  557.   Originally: Olaf 'Olsen' Barthel <olsen@sourcery.han.de>
  558.   Currently: Samuel Devulder <devulder@info.unicaen.fr>
  559.   Available: Not quite sure yet. Paul Liss' Web page has binaries.
  560.  
  561. XFree86/OS2 port:
  562.   Krister Bergman <bellman@kuai.se>
  563.   Available: <http://www.kuai.se/~bellman/html/xfreeapps.html>
  564.  
  565. Since I generally don't have the possibility to test or improve these ports,
  566. it is a good idea to contact their respective authors if you have questions.
  567.  
  568.  
  569. Before you email...
  570. ===================
  571.  
  572. Before you contact me with a problem that you have, make sure you have read
  573. _all_ of the above. Please read also the file "FAQ", which contains a lot of
  574. helpful informationm, and the README file for your specific system. 
  575.  
  576. I can't answer _every_ question. If you have trouble understanding this
  577. README, either because you don't speak English very well or because you have
  578. no clue at all about computers, please try to find some friend of yours who 
  579. does understand this file and who can translate/explain it for you. I simply
  580. can't explain (for example) how to use terminal programs or CrossDOS because
  581. I don't use either, and it would be much too time-consuming anyway. This file
  582. and the file FAQ contains about every piece of information I can give you. I 
  583. try to help people who have questions, but sometimes it takes too much time.
  584.  
  585. Please don't ask for Kickstart ROM files or other copyrighted software. Don't
  586. _send_ me stuff like this either. If you want to send me something else which
  587. is big (>= 50K), ask me before or put it somewhere in Webspace.
  588.  
  589. Oh, and another thing: If I promise to do things (like implement new
  590. features), and forget about them, pester me. That happens occasionally, it's
  591. a known bug in my brain. I'll have it replaced.
  592.